home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2004 April / Gamestar_61_2004-04_dvdb.iso / DVDStar / Editace / hltp.exe / {app} / Applications / MilkShape 3D / msL3DTools.txt < prev    next >
Encoding:
Text File  |  2001-11-21  |  5.6 KB  |  114 lines
  1. MilkShape L3D Importer/Exporter Plug-Ins and CBN/HD Builder Plug-In,
  2.     v0.97a beta
  3. (c) 2001 DragonZap, dragonzap1@aol.com
  4.  
  5. These plug-ins for Milkshape are provided as-is, and I assume no
  6. responsibility whatsoever for any damage they may cause.
  7. I tried putting in basic range checking, but they may crash on bad
  8. files. And then again maybe they won't.
  9.  
  10. HOW TO USE:
  11.     1. Put the included "msL3DImporter.dll", "msL3DExporter.dll",
  12.        "msBWCCompiler.dll", "msHDDecompiler.dll", "FreeImag2.dll",
  13.        and "msCPP.dll" files in your Milkshape program directory.
  14.        (Overwriting the existing "msCPP.dll" of Milkshape 1.5.9 or
  15.        earlier should be OK.)
  16.     2. Run Milkshape. You'll find them listed under the "Import,"
  17.        "Export," and "Tool" menus.
  18.  
  19. Note that a registered version of MilkShape is NOT required to use
  20. the plug-ins (MilkShape doesn't provide any way for plug-ins to
  21. check to see if the copy is registered anyway) -- however, MilkShape
  22. has a 30-day trial period, and after that expires, NO plug-ins will
  23. work.
  24.  
  25. What the plug-ins CAN do
  26. ------------------------
  27. Import existing L3D models
  28. Allow you to export new meshes and/or skins for L3D models which can be
  29. used in-game
  30. Change some minor aspects of creatures, such as hair color and length,
  31. and tattoo positions.
  32.  
  33. What the plug-ins CAN'T do
  34. --------------------------
  35. Import animations
  36. Set eyeball and hair positions (they can be changed, but I don't know
  37.     how they are determined just yet)
  38. Change the creature footprints
  39. Change the creature skeletons and animations
  40. Vertex blending
  41.  
  42. Details
  43. -------
  44.  
  45. The import plug-in imports Black & White .L3D model files, although not
  46. perfectly. You'll get a mesh with UV coordinates, and you can get a skeleton
  47. with correct position information but lost rotation information. The problem
  48. is that Black & White models use transformation matrices to show off their bone
  49. positions, and such matrices also support scaling and skewing, which MilkShape
  50. does not. This makes proper import a bit difficult. Sorry. On the other hand,
  51. skeletons in L3D files which have been exported from MilkShape originally can
  52. be imported correctly without a problem.
  53.  
  54. Alpha textures are extracted, but are assigned only if the L3D file says
  55. they are used. All textures are saved as .BMP files, currently.
  56.  
  57. When creating a model to be used in-game, you will probably want to use an
  58. existing skeleton, since A) no .ANM importer/exporter has yet been written
  59. at the time of this writing, and B) you can use the existing animations of
  60. whatever model you intend to replace. To do this, you will want to import
  61. the existing skeleton using the "Import without rotation information" option
  62. to get the correct bone positions. Although you should be able to rename bones
  63. without problem, do not add/remove/rearrange the bones in any way, or this
  64. process may not work. Anyways, after you create your model, you can assign
  65. the bones to your vertices. When you go to export, make sure to select the
  66. "Use existing skeleton" option, and select the file you originally got the
  67. skeleton from. Due to some problems with MilkShape's texture filename handling,
  68. your model file, your original skeleton file, and all your texture files
  69. should probably be in the same directory, or you may find your exported
  70. model has no textures.
  71.  
  72. Black & White uses 256x256 textures with RGBA4444 color format, which allows for
  73. 4096 colors and 16 alpha values. All colors will be quantized to fit this range.
  74. Valid image formats are any of those supported by the FreeImage library.
  75. (This is generally any of the ones MilkShape already supports, such as BMP,
  76. TGA, etc.) If an image is not 256x256 pixels, it will be scaled to fit. Thus,
  77. you should probably stick to 256x256 textures, lest you find your L3D files
  78. either suddenly become massive or your textures don't quite have the quality
  79. that you thought they did.
  80.  
  81. I'm not clear on how Black & White determines eyeball or hair positions,
  82. (they're in the .CBN files, but I'm not sure what the exact meaning of the
  83. fields is) so those are not properly supported.
  84.  
  85. Version history:
  86. 0.90    - First beta release
  87. 0.91    - Added support for texture extraction and assignment
  88. 0.95    - Fixed a few bugs, and released the exporter along with the importer
  89. 0.95a    - Fixed a stupid mistake on my part; sorry about the last one, folks.
  90.       ...but this is why it's still beta.
  91. 0.96    - Added support for preserving morph targets -- this means you can
  92.       create models based on existing meshes which will work with the
  93.       originals if you're so inclined. This also means you can replace
  94.       individual models (rather than all seven for creatures) and make
  95.       modifications to the hand meshes without the game crashing
  96.       (as far as I can tell).
  97. 0.97    - Added minor support for modifying .CBN files, as well as some simple
  98.       bone naming based on .CBN information. Different rendering modes are
  99.       now supported for export. Also turned most of the strings in the DLLs
  100.       to string tables, for those of you who know how to use resource
  101.       editors and want to translate the plug-ins into your own native
  102.       language.
  103. 0.97a    - L3D Importer:
  104.           More bones named automatically when the right .CBN file is used
  105.           for import.
  106.       L3D Exporter:
  107.           Fixed a bug in exporting texture IDs for L3D files that were
  108.           exported using another L3D file as a base.
  109.           Added ability to replace only skins.
  110.       BWC Compiler:
  111.           Added lots more commands to .BWC files and removed the "hairinfo"
  112.           command (obsolete).
  113.           Added support for compiling .HD files.
  114.       Added HD Decompiler.